home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / ozcis4.zip / FILES.DOC < prev    next >
Text File  |  1992-03-08  |  36KB  |  961 lines
  1.  
  2.  
  3.  
  4.  
  5.                 File: FILES.DOC -- OZCIS AND FILE MANAGEMENT
  6.  
  7.                 INTRODUCTION
  8.  
  9. CompuServe contains a large number of files of various kinds, stored
  10. in the file libraries of its forums. Navigating your way through the
  11. libraries and file descriptions would be a tedious job if you had to
  12. do it all manually. OzCIS has a number of procedures that make viewing
  13. file information, and uploading and downloading files, simple and
  14. mostly automatic.
  15.  
  16. Typical procedure: Open a forum's configuration dialogue and tell
  17. OzCIS the numbers of file libraries whose contents you want to view.
  18. On the next 1st or 2nd pass, OzCIS retrieves either brief or detailed
  19. file lists - or both kinds if you want.
  20.  
  21. Then - off-line - you view the file lists, make selections from them,
  22. assemble a list of files to download, and have OzCIS log back onto CIS
  23. and fill your order.
  24.  
  25. The retrieval of abbreviated file information is a "short scan" that
  26. provides a "short-format catalogue." Retrieval of detailed file
  27. information is a "long scan" and provides a "long-format catalogue."
  28. An "update" is a long scan that retrieves only new or changed
  29. information from a library.
  30.  
  31.  
  32.                 GETTING LIBRARY INFORMATION
  33.  
  34. By now you should have had OzCIS do a configuration pass for the
  35. forums that interest you. If so, there is now a file with the
  36. extension .SEC in each forum's directory. .SEC files contain lists
  37. of forum discussion sections and forum library numbers and names.
  38. OzCIS uses the .SEC file to provide a pick-list of library names and
  39. numbers.
  40.  
  41. If you have not done a forum config pass yet, we suggest you do so -
  42. unless you know all of the names and numbers of your favorite forum
  43. libraries by heart. Making a forum config pass is covered in the OzCIS
  44. documentation file FORUMS.DOC.
  45.  
  46.  
  47.                 WHICH KIND OF SCAN?
  48.  
  49. A SHORT scan retrieves a list similar to what you'd see if you give
  50. the command "DIR" at a library's "!" prompt. Here is a representative
  51. line from a short scan:
  52.  
  53.   NEWDTP.ZIP  5   28K 11-22-91 Extensive comparison of DTP programs
  54.  
  55.  
  56.  
  57.  
  58.  
  59.   ------------------------------------------------------------------
  60.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 109
  61.  
  62.  
  63.  
  64.  
  65. That's it. The short-format listing gives you only file name, library
  66. number, size in "K," file date, and a brief description.
  67.  
  68. A LONG scan gives you information similar to what you'd see if you
  69. give the command "BROWSE" from a library's "!" prompt:
  70.  
  71.   [12345,6789]    Lib: 5
  72.   NEWDTP.ZIP/Bin  Bytes:  28288, Count:   89, 22-May-91
  73.  
  74.     Title   : Extensive comparison of DTP programs
  75.     Keywords: DTP MAC PC DOS REVIEWS PROGRAMS COMPARISON
  76.  
  77.     Archive contains text file - abstracts from various trade mags'
  78.     reviews of the latest versions of major (and some minor) DTP
  79.     programs for Mac, PC, other platforms. Covers features lists,
  80.     strengths and weaknesses, quality of tech support, prices.
  81.  
  82. Here you also have information on the UserID of the uploader, the
  83. library number, the file name and file type, exact file size in bytes,
  84. number of times the file has been downloaded ("Count"), file date, and
  85. an brief and detailed descriptions. The "Keywords" are short
  86. descriptive words added by the file's uploader (and/or the forum
  87. sysops) to facilitate file searches.
  88.  
  89. The long-scan file OzCIS writes can be from 5 to 8 times larger than
  90. the one it writes during a short scan. If you don't know for starters
  91. how many files there are in a library that interests you, we suggest
  92. you first do a short scan.
  93.  
  94. Once you've looked at the short-format catalogue, you can get a better
  95. idea whether or not you want to do a long scan in the library. Doing
  96. the short scan holds down your connect-time and saves hard disk space.
  97.  
  98.         FILES WRITTEN DURING A SCAN
  99.  
  100. During a LONG scan OzCIS writes a file (in the forum's subdirectory)
  101. whose base name is the first 8 characters of the forum's "GO" word and
  102. whose extension begins "L" and ends with the library number. A long
  103. scan of the DTPFORUM's library 5 would produce the file DTPFORUM.L5.
  104. The result of a SHORT scan is a similarly-named file, but with an ".S"
  105. extension. A short scan of DTPFORUM, library 12, would result in the
  106. file DTPFORUM.S12. During an UPDATE OzCIS writes a file with a name
  107. like DTPFORUM.U3 (that would be an update taken from DTPFORUM's
  108. library 3).
  109.  
  110.  
  111.                 PICKING THE LIBRARIES TO SCAN
  112.  
  113. Choose a forum via FORUMS > SELECT FORUMS > AVAILABLE FORUMS.
  114. Then select FORUMS > PASS OPTION SETTINGS to open the main forum
  115. configuration dialogue.
  116.  
  117.  
  118.  
  119.   ------------------------------------------------------------------
  120.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 110
  121.  
  122.  
  123.  
  124.  
  125. The lower "panel" of the dialogue ("1st/2nd One-Pass Options")
  126. contains SCAN LIBS (LONG) and SCAN LIBS (SHORT) data fields.
  127.  
  128. Fill in either or both fields the same way you have filled in section-
  129. number fields: Enter a library number into the field; if you enter
  130. more than one number, put commas between the numbers. Do NOT type
  131. spaces between the numbers and commas.
  132.  
  133. To see a pick-list of library names and numbers, press F2 when the
  134. cursor is in either the long-scan or short-scan field.
  135.  
  136. A window named "LIBRARIES" opens at the right side of the screen.
  137. Select a single library by highlighting it with the cursor bar and
  138. pressing ENTER (or by left-clicking it). Select more than one library
  139. by tagging multiple entries with the space bar; a check-mark appears
  140. next to the selected entries. When you're done selecting them, press
  141. ENTER or F10 to confirm (or ESC to abort). Select all libraries by
  142. typing "ALL" into the field or selecting "ALL" from the bottom of the
  143. pick-list. To the immediate right of each SCAN LIBS field there's a
  144. "Y/N" field. When you're ready to do a scan, make sure to change "N"
  145. to "Y" for whichever field applies to the scan you want done.
  146.  
  147. It's not safe to assume each message section in a forum has an
  148. associated file library with the same number. If in doubt, check the
  149. library pick-list.
  150.  
  151. Do NOT enter SECTION names into the SCAN LIBS data fields!
  152.  
  153. Close the dialogue and save the new configuration by pressing F10. Or
  154. press ESC to close the dialogue without saving new information.
  155.  
  156. NOTE:  After the scan, OzCIS will automatically change a "Y" to the
  157.        right of a SCAN LIBS field back to "N". The library numbers
  158.        will remain as-is in the data to the right of the "Y/N" field.
  159.        If you need to scan again, you'll need to open the config
  160.        dialogue and change the "N" back to "Y" again. Options
  161.        in this part of the dialogue are executed only once before
  162.        being reset.
  163.  
  164.  
  165.         THE "UPDATE" FIELD
  166.  
  167. Library contents change all the time. Set the UPDATE field to "Y" to
  168. have OzCIS perform a long scan in selected libraries, retrieving ONLY
  169. NEW OR CHANGED INFORMATION. Using "update" rather than scanning from
  170. scratch can save you considerable time on-line, especially in large
  171. libraries. (However, don't set this option to "Y" if you have never
  172. before done a file scan.)
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.   ------------------------------------------------------------------
  180.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 111
  181.  
  182.  
  183.  
  184.  
  185.                 EXECUTING THE SCANS
  186.  
  187. Short and long scans are executed during either a 1st or 2nd pass.
  188. OzCIS first takes care of any CISMail or forum messages, then does
  189. scans, updates, or other work set up in the bottom "panel" of the
  190. forum configuration dialogue.
  191.  
  192.         IF YOU HAVE TO INTERRUPT A SCAN ...
  193.  
  194. Keep in mind that if you're logged on at 9600 baud, the following
  195. procedure might not work very well. At 2400 baud or slower, it should
  196. work ok.
  197.  
  198. As the file information is scrolling down the screen, press ^C - the
  199. normal CIS (not OzCIS) "abort" command. When CIS detects the ^C it
  200. presents a menu of choices. Select the one that returns you to the
  201. prior menu (don't choose "continue").
  202.  
  203. You are now at a CIS "!" prompt. OzCIS is still in the middle of its
  204. automated routine, but you'll have (deliberately) thrown it off the
  205. track; it won't be trying to do anything right at the moment.
  206.  
  207. Abort the automatic pass by pressing ESC once (and once ONLY). OzCIS
  208. then presents you with several choices, including ESC to log off
  209. immediately or "T" to go into on-line-terminal mode.
  210.  
  211. Don't press ESC - that tells OzCIS to drop carrier - not a good way to
  212. log off CIS. Press "T" to go into terminal mode. When the terminal-
  213. mode menu appears at the top of the screen, select EXIT (keystroke:
  214. ALT-X) to make OzCIS log off CIS normally.
  215.  
  216. If you abort this way, OzCIS will have written as much of the scan-
  217. file as it could write before you pressed ^P. You can leave the
  218. partially-written scan file in the forum's directory or delete it -
  219. your choice. If you do another scan in the same library later on, the
  220. partial file will be over-written by the new scan.
  221.  
  222.  
  223.  
  224.                 VIEWING CATALOGUES AND ABSTRACTS
  225.  
  226. After retrieving file information, select FORUMS > DOWNLOAD FILE(S).
  227.  
  228. This command opens a sub-menu with four choices.
  229.  
  230. SHORT LISTINGS
  231.  
  232.   After selecting the library to view, you are able to scroll though a
  233.   list of its files, including a brief description of each file. If
  234.   you have also done a long scan for this library, you can view
  235.  
  236.  
  237.  
  238.  
  239.   ------------------------------------------------------------------
  240.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 112
  241.  
  242.  
  243.  
  244.  
  245.   extended file descriptions from the short-scan window and/or pick a
  246.   file or files to download. More on that shortly.
  247.  
  248. LONG LISTINGS
  249.  
  250.   After selecting the library to view, you see a list of files similar
  251.   in appearance to the list shown via SHORT LISTINGS. There are some
  252.   additional options, including searching for text within the list.
  253.   This command is also explained in greater detail below.
  254.  
  255. MANUAL INPUT
  256.  
  257.   This command opens a dialogue called INPUT DOWNLOAD FILE INFO. The
  258.   dialogue can also be opened when you are viewing a short- or long-
  259.   format file listing and will be explained in the "Viewing A Short-
  260.   Format Catalogue" section, below.
  261.  
  262. EDIT LIST
  263.  
  264.   If you've selected files (by any method) to download from one or
  265.   more forum libraries, this selection opens a window that allows you
  266.   to make changes in the list of downloads - including removing files
  267.   from the list. The command opens a PENDING DLS window, also
  268.   accessible when you are viewing file catalogues. See "Viewing A
  269.   Short-Format Catalogue," just below.
  270.  
  271.  
  272.  
  273.         VIEWING A SHORT-FORMAT CATALOGUE
  274.  
  275. Selecting FORUMS > DOWNLOAD FILE(S) > SHORT LISTINGS opens a LIBRARIES
  276. window at the right of the screen, showing all of the forum libraries
  277. in the .SEC file OzCIS retrieved when you did the forum configuration
  278. pass. This is a pick-list from which you select one library at a time
  279. for viewing. If you have not yet done a short scan for the library you
  280. select, OzCIS notifies you that it can't find the necessary file and
  281. returns you to the FORUMS > DOWNLOAD FILE(S) sub-menu.
  282.  
  283. (Shortcut: When you are looking at the "Libraries" pick-list,
  284. pressing, say, "5" makes the cursor bar jump to the line for
  285. library number 5.)
  286.  
  287. If the short-format file (with an extension of .S, plus library number)
  288. exists, a window opens showing the complete library directory, with a
  289. one-line listing for each file (see the example above in the section
  290. called "Which Kind of Scan?"). The window is called SHORT FORMAT SCAN
  291. OF (followed by the selected forum name and library number).
  292.  
  293. The list can be scrolled with the PG UP and PG DN keys or with the
  294. mouse (HOME, END, and other screen-control keys are not active when
  295.  
  296.  
  297.  
  298.   ------------------------------------------------------------------
  299.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 113
  300.  
  301.  
  302.  
  303.  
  304. you open this window). The cursor bar can be moved from file to file
  305. via the UP- and DOWN-arrow keys.
  306.  
  307. The window has a number of menus, explained here not in strict left-
  308. to-right order but in order from simplest to least simple:
  309.  
  310. QUIT  (ALT-Q)
  311.  
  312.   Return to the main screen. Alternative: Press ESC.
  313.  
  314. HELP  (ALT-H)
  315.   Brings up a help-window with information about viewing
  316.   short scans. Alternative: Press F1.
  317.  
  318. EXTERNALS  (ALT-X)
  319.  
  320.   Call an external program. Externals are discussed in the documentation file
  321.   MISC.DOC.
  322.  
  323. EDITOR  (ALT-E)
  324.  
  325.   Opens OzCIS' General Editor.
  326.  
  327. LIBCHANGE  (ALT-L)
  328.  
  329.   View a different library (short scan catalogue). This command opens a
  330.   LIBRARIES window on the right side of the screen. Select a library
  331.   from the pick-list or press ESC to close the window without switching.
  332.   If OzCIS can't find a file associated with your choice, you'll get an
  333.   error-message saying so.
  334.  
  335.   NOTE:  You cannot use LIBCHANGE to change from viewing a short-
  336.          format catalogue to viewing a long-format catalogue - only to
  337.          another short-format catalogue.
  338.  
  339. REQUEST
  340.  
  341.   A "Request" asks OzCIS to retrieve an abstract for the file
  342.   currently highlighted by the cursor bar. (An abstract is detailed
  343.   file information. See above - "Which Kind of Scan?" - for an
  344.   example.) OzCIS asks you to confirm this selection. If you confirm
  345.   it, OzCIS writes a file with the forum's name as its base name and
  346.   the extension .SLR ("single library request"), containing filename
  347.   and library-number information about one or more files to be
  348.   "abstracted." The abstract is retrieved during OzCIS' next trip into
  349.   the forum, after which the .SLR file is deleted.
  350.  
  351.   The abstract, when retrieved this way, is stored in a file with a
  352.   ".U" extension (example: DTPFORUM.U5, which would be created if you
  353.   request abstracts for files in library 5 of the DTPFORUM). The ".U"
  354.  
  355.  
  356.  
  357.   ------------------------------------------------------------------
  358.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 114
  359.  
  360.  
  361.  
  362.  
  363.   file is later merged into a long-format file for that library (if
  364.   you have such a file), then erased.
  365.  
  366.   If you don't have a long scan file at all: If you are viewing a
  367.   short scan catalogue and ask for an abstract of a file now present
  368.   in a ".U" file, selecting "Abstract" here will display the detailed
  369.   information for the highlighted file.
  370.  
  371. DOWNLOAD  (ALT-D or ENTER)
  372.  
  373.   "Download" is the default if you press ENTER while viewing a short-
  374.   format list. The command opens an INPUT DOWNLOAD FILE INFO dialogue
  375.   at the bottom of the screen. These are its data fields:
  376.  
  377.   CIS NAME. OzCIS will already have filled in the name of the file
  378.   highlighted by the cursor bar when you gave the "download" command.
  379.  
  380.   LIBRARY. OzCIS will already have provided the number of the library
  381.   whose file catalogue you're now viewing.
  382.  
  383.   LOCAL NAME. The cursor will be in this field. If you want OzCIS to
  384.   write a file to disk with a name different from CIS' name for the
  385.   file, enter the information here. You can include path information
  386.   if you like; if you type a path, you MUST also include a file name.
  387.   Entering nothing in this field tells OzCIS to store the file using
  388.   its present CIS name and store it in the forum's own subdirectory.
  389.  
  390.   NOTE:  No wildcards allowed in this field! Use of wildcards in the
  391.          file name will probably result in a CIS error message like
  392.          "Remote out of disk" during the attempt to download the file.
  393.  
  394.   Press F10 to save the information about the file to be downloaded.
  395.   Pressing ESC closes the dialogue without saving the information.
  396.  
  397.   When you confirm information in this dialogue, OzCIS writes a file
  398.   with the extension ".DL" into the forum's subdirectory (example:
  399.   DTPFORUM.DL). The files listed in the .DL file are downloaded during
  400.   either the next 1st pass or next 2nd pass to the forum, after which
  401.   OzCIS erases the .DL file.
  402.  
  403.   Downloaded files are stored in the selected forum's directory if you
  404.   have not provided path information within the LOCAL NAME field of
  405.   the download-information dialogue.
  406.  
  407. VIEWDLS  (ALT-V)
  408.  
  409.   Allows you to review the list of files you've asked OzCIS to
  410.   download (the contents of the .DL file). If there is no such file,
  411.   you get only an error message. Otherwise, a window called "PENDING
  412.   DLS FOR [name of forum being viewed]" opens at the top of the
  413.   screen, with several menu items:
  414.  
  415.  
  416.  
  417.   ------------------------------------------------------------------
  418.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 115
  419.  
  420.  
  421.  
  422.  
  423.   ADD. Re-opens a blank "INPUT DOWNLOAD FILE INFO" dialogue, allowing
  424.   you to add a new name to the existing list of downloads.
  425.  
  426.   DELETE. Removes the file now highlighted by the cursor bar in the
  427.   PENDING DLS dialogue. If there is only one file in the list and you
  428.   delete it, the .DL file itself is deleted.
  429.  
  430.   EDIT. Opens the INPUT DOWNLOAD FILE INFO dialogue, discussed above
  431.   in the discussion of the "Download" menu.
  432.  
  433.   HELP. Opens OzCIS' help window. Alternative: Press F1.
  434.  
  435.   QUIT. Closes the "PENDING DLS" window and returns you to the short-
  436.   format file list.
  437.  
  438. ABSTRACT
  439.  
  440.   Allows you to view detailed information (the "abstract") for the file
  441.   now highlighted by the cursor bar.
  442.  
  443.   If there is a long-format catalogue (".L file) or an update (".U"
  444.   file) containing the abstract for this particular file, OzCIS opens
  445.   a full-screen window called ABSTRACT FOR FILE (followed by the name
  446.   of the file currently highlighted by the cursor bar). If there is
  447.   neither a long scan file nor update file available, OzCIS displays
  448.   an error message and returns you to the short-format catalogue
  449.   window. The window containing the abstract might not open right
  450.   away. There will be a delay if OzCIS needs to index the long-format
  451.   file, and/or if OzCIS needs to merge any library update-files into
  452.   the long-format file.
  453.  
  454.   The display shows several kinds of information about the file. To
  455.   review (using the same example used earlier-on):
  456.  
  457.     [12345,6789]    Lib: 5
  458.  
  459.   The UserID number of the person who uploaded the file, and the
  460.   library where the file is stored.
  461.  
  462.     NEWDTP.ZIP/Bin  Bytes:  28288, Count:   89, 22-May-91
  463.  
  464.   The file's name, file type ("Bin" in this case - meaning "binary"),
  465.   size, number of times downloaded ("Count"), and the date the file
  466.   was uploaded. (File types will be explained in the section on
  467.   uploads.)
  468.  
  469.     Title   : Extensive comparison of DTP programs
  470.  
  471.   The short title the uploader gave the file; this is the same
  472.   description line you see in the short-format catalogue window.
  473.  
  474.  
  475.  
  476.  
  477.   ------------------------------------------------------------------
  478.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 116
  479.  
  480.  
  481.  
  482.  
  483.     Keywords: DTP MAC PC DOS REVIEWS PROGRAMS COMPARISON
  484.  
  485.   Words the uploader (or sysops) provided to facilitate on- or off-
  486.   line searches for files.
  487.  
  488.   Finally, there is an extended description for the file (which we
  489.   won't repeat right here).
  490.  
  491.   You cannot edit any text in the abstract window. However, you can
  492.   highlight text using the block commands used in most of OzCIS'
  493.   editors; a block of text copied to the clipboard from this window
  494.   can be pasted into an editing-window later on.
  495.  
  496.   Menu items when viewing the abstract-information:
  497.  
  498.   NEXT  (ALT-N; alternative: PG DN). Get abstract-information for the
  499.   next file in the list. If you are now viewing information stored in
  500.   an  update file and that is the ONLY information in it, you will get
  501.   an error message, since there ISN'T any "next" file. Otherwise,
  502.   OzCIS gets an abstract for the next file in the list. (This is a
  503.   quick way to view a number of abstracts in a row without having to
  504.   return first to the short-format catalogue window.)
  505.  
  506.   PREVIOUS (ALT-P; alternative: PG UP). View an abstract for the
  507.   previous file in the catalogue.
  508.  
  509.   DOWNLOAD (ALT-D). Download the file whose abstract you're now
  510.   reading. This command brings up the INPUT DOWNLOAD FILE INFO
  511.   dialogue discussed above.
  512.  
  513.   VIEWDLS (ALT-V). Review pending file downloads. Opens the PENDING
  514.   DLS window (see above).
  515.  
  516.   EDITOR  (ALT-E). Opens the General Editor. Any text you've copied
  517.   from an abstract to the clipboard can be pasted into the editor.
  518.  
  519.   RETURN  (ALT-R; alternative: ESC). Close the viewing window and
  520.   return to the short-format catalogue window.
  521.  
  522.  
  523.         VIEWING A LONG-FORMAT CATALOGUE
  524.  
  525. Select FORUMS > DOWNLOAD FILE(S) > LONG LISTINGS to open the LIBRARIES
  526. window at the right of the screen. Pick a library for which you've
  527. previously done a long scan (you'll get an error message if there is
  528. no long-format file for the selected library).
  529.  
  530. OzCIS opens a window called LONG FORMAT SCAN OF [library name]. Its
  531. file  display and most of its menus are exactly like those of the
  532. short-format catalogue window. The QUIT, HELP, EDITOR, EXTERNALS, and
  533. VIEWDLS commands (and their associated keystrokes) are exactly the
  534.  
  535.  
  536.  
  537.   ------------------------------------------------------------------
  538.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 117
  539.  
  540.  
  541.  
  542.  
  543. same. DOWNLOAD is shortened to DNLOAD to take up less space. There are
  544. a few new commands:
  545.  
  546. LIBCH  (ALT-L)
  547.  
  548.   Change Library. This name is also shortened. Selecting LIBCH allows
  549.   you to switch to another library's long-format catalogue listing
  550.   (not to a library's short-format catalogue listing).
  551.  
  552. SORT  (ALT-S)
  553.  
  554.   Allows you to sort the display of files using one of three criteria:
  555.  
  556.   NAME. This is the default sorting method: Sort alphabetically by
  557.   file name.
  558.  
  559.   DATE. Sort by date, with the newest files at the top of the list.
  560.  
  561.   UPLOADER. An ascending-order sort by UserID number of the people who
  562.   uploaded the files.
  563.  
  564.   There is a short delay as the file listing is sorted; OzCIS re-
  565.   writes the index for the long-format file. If no index yet exists,
  566.   OzCIS will first build one.
  567.  
  568. ABSTRACT  (ALT-A)
  569.  
  570.   The window that opens when you request an abstract is virtually
  571.   identical to the one shown when you're viewing files in the short-
  572.   format-catalogue window. There is one difference:
  573.  
  574.   Back in the old days (a few documentation files ago), you went
  575.   through OzCIS' general configuration. At that time you chose between
  576.   "Y" or "N" in answering the question: "Uploader in Abstracts?" If
  577.   you answered "Y," viewing an abstract from the long-format catalogue
  578.   window displays not just the uploader's UserID, but his or her name
  579.   as well - IF that UserID number is also in your own OzCIS Address
  580.   Book. The display looks like this:
  581.  
  582.   [12345,6789]    Lib: 5   Uploader: Melvina Cowznofski
  583.  
  584.   Enabling this option increases the time it takes OzCIS to index the
  585.   long-format catalogue, especially if you have a large Address Book.
  586.  
  587.   The menu commands available in the abstract-window are the same as
  588.   those discussed above in the section on viewing an abstract from a
  589.   short-format catalogue listing.
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.   ------------------------------------------------------------------
  598.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 118
  599.  
  600.  
  601.  
  602.  
  603. KEYSRCH  (ALT-K)
  604.  
  605.   This means "keyword search" - allows you to search the library for
  606.   words in "keywords" lines. Pressing ALT-K opens a window with a
  607.   field into which you type the keyword. OzCIS temporarily turns on
  608.   capitalization (keywords are always in caps). Type the word, then
  609.   press ENTER. Another window opens in which you enter one (or both)
  610.   of two single-letter search flags:  G  for a global search - through
  611.   the entire list, or  B  to search backward through the list. When
  612.   OzCIS finds a file whose keyword line contains the searched-for
  613.   word, it positions the cursor bar onto that line in the window, then
  614.   displays the abstract for that file.
  615.  
  616.   This abstract-window is different from others you've seen. Its top-
  617.   line menu contains only two commands:
  618.  
  619.   NEXT SEARCH (ALT-N): Resume the search. The abstract-window closes
  620.   and the search continues in the long-format-catalogue window. If there
  621.   is another "find," the cursor bar jumps to the next file where
  622.   there is a match, and then its abstract-window opens.
  623.  
  624.   Alternatives to ALT-N: You can use ^L for "resume search," either
  625.   when you're viewing the catalogue window or the abstract displayed
  626.   after a "find." When you're viewing the abstract, PG DN will also
  627.   execute the "resume search" command. Both ^L and PG DN will execute
  628.   "resume search" backward if you have set the "B" flag.
  629.  
  630.   RETURN  (ALT-R): Return to the long-format-catalogue window.
  631.  
  632.  
  633.                 UPLOADING FILES TO A FORUM LIBRARY
  634.  
  635. Selecting FORUMS > UPLOAD FILE(S) opens a full-screen window titled
  636. FORUM UPLOAD INFORMATION. As with other FORUMS menu items, this
  637. selection is not accessible until you've picked a forum from the
  638. AVAILABLE FORUMS window. The upload-dialogue's data fields are:
  639.  
  640. FILE NAME
  641.  
  642.   Enter the name (including path information, if necessary) of the
  643.   file as it now exists on your system. Press F2 for a standard OzCIS
  644.   file pick-list for the current directory. If you use the pick-list
  645.   to select a file in some other directory or on another disk drive,
  646.   OzCIS inserts the full path information for the file into the FILE
  647.   NAME field.
  648.  
  649.   Or type a file name containing wildcards and press ENTER (not F2) to
  650.   bring up a pick-list showing only files matching the name-criteria
  651.   you typed. (Pressing F2 alone is equivalent to typing "*.*" into the
  652.   FILE NAME field and then pressing ENTER.)
  653.  
  654.  
  655.  
  656.  
  657.   ------------------------------------------------------------------
  658.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 119
  659.  
  660.  
  661.  
  662.  
  663.   If OzCIS cannot find the file whose name you've entered here, it
  664.   displays an error-alert the moment you move the cursor out of the
  665.   FILE NAME field.
  666.  
  667.   Enter only ONE file name into this field.
  668.  
  669. CIS NAME
  670.  
  671.   Files stored in libraries have "base" names of no more than 6
  672.   characters. Shorten the name to 6 characters, if necessary. (If you
  673.   don't, CIS will truncate the name on its own.) Do NOT include path
  674.   information of any kind in this field.
  675.  
  676. LIBRARY
  677.  
  678.   If you know the number of the library where you want the file
  679.   stored, enter it here. Or press F2 for a pick-list of the forum's
  680.   libraries (if you have a .SEC file for this forum).
  681.  
  682. FILE TYPE
  683.  
  684.   CIS libraries contain a number of different file types; your upload
  685.   must describe the "type" correctly. With the cursor in the FILE TYPE
  686.   field, toggle among the available "types" by pressing the space bar:
  687.  
  688.   BINARY (the default)  Archive files, like those created by PKZIP or
  689.   LHA on the PC, or Compact Pro on the Mac, are binary files. So are
  690.   executable programs or text files saved in a word-processor's
  691.   proprietary file format. Binary files are 8-bit data and are not to
  692.   be changed in any way. This kind of file can only be downloaded; it
  693.   cannot be viewed on-line.
  694.  
  695.   ASCII   A plain-text file, which can be viewed on-line via CIS'
  696.   "read" command. Files created by most text editors - PC-Write,
  697.   Qedit, and the like - are plain-text files. Those created by most
  698.   word processors (Microsoft Word, WordPerfect, and so on) are not
  699.   plain-text files unless you save the files using the programs'
  700.   "save unformatted" options.
  701.  
  702.   NOTE:  Uploading a binary file but telling CIS it is "ASCII" will
  703.          trash the contents of the file, making it useless.
  704.  
  705.   GIF   This type should always be used for GIF (Graphics Interchange
  706.   Format) image files and ONLY for GIF files. A GIF image file can be
  707.   viewed on-line by OzCIS and other CIS navigation programs. If you
  708.   upload a GIF file as "Binary," it will not be viewable on-line even
  709.   if the file's extension is .GIF.
  710.  
  711.   RLE   Like GIF, but used for the older RLE graphics format. RLE has
  712.   all but disappeared from CIS. Supported only for compatibility.
  713.  
  714.  
  715.  
  716.  
  717.   ------------------------------------------------------------------
  718.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 120
  719.  
  720.  
  721.  
  722.  
  723.   NAPLPS   Like GIF and RLE, but for the old NAPLPS (North American
  724.   Line Print Standard) format. This format has extremely limited use
  725.   on CIS, but is supported here for compatibility. Used only for
  726.   NAPLPS files of the proper format.
  727.  
  728.   IMAGE   A special type used only by some non-PC-compatible computers
  729.   such as the small Commodores and Ataris. Most people will never use
  730.   this kind of file, but "Image" is also provided for compatibility.
  731.   Never select "Image" when you upload files to be used on either an
  732.   IBM-compatible or Macintosh computer.
  733.  
  734. KEYWORDS
  735.  
  736.   These are words used in indexing and during a search for files
  737.   matching a specific class or category. They're the words used when
  738.   you give an on-line command like "BRO KEY: word". Keywords should be
  739.   typed as single words, each separated from the next by a single
  740.   space. You can type up to 10 keywords for each file. The maximum
  741.   number of characters in this whole field is 80; no one keyword can
  742.   be longer than 17 characters.
  743.  
  744.   Once sent to CompuServe, keywords are fed thru a "Stoplist" filter
  745.   that removes common words such as "I", "AN", "OR", "MY", and so on.
  746.   Contractions or hyphenated words ("CAN'T", "VER-1" etc.) are
  747.   stripped of punctuation and treated as two separate words. Many
  748.   punctuation marks are disallowed altogether. OzCIS understands this
  749.   and strips the line for you, if necessary.
  750.  
  751. TITLE
  752.  
  753.   A short description - 49 characters or less. The "title" is the one-
  754.   line description you see in an OzCIS short-format catalogue (or when
  755.   you give the command "dir" at a CIS library "!" prompt).
  756.  
  757. DESCRIPTION
  758.  
  759.   A free-form description of the file, up to 549 characters long - the
  760.   information shown when you ask OzCIS to display a file's abstract
  761.   (the same information displayed on-line when you give a "browse"
  762.   command at a CIS library "!" prompt).
  763.  
  764.   The editing area supports a part of the General Editor's command
  765.   set, including its cursor movement keys, block and clipboard
  766.   commands, commands for changing case and searching, and some others.
  767.   Experiment a bit here (there are no menus).
  768.  
  769.   The status-line in the editing window shows how many characters
  770.   you've entered. If you reach the limit, OzCIS displays an error-
  771.   alert. After you reach the limit, you can't type any more past
  772.   the last character unless you first erase some other text within
  773.   the window.
  774.  
  775.  
  776.  
  777.   ------------------------------------------------------------------
  778.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 121
  779.  
  780.  
  781.  
  782.  
  783.   Before you put the cursor into the editing window, the UP and DOWN
  784.   keys move the cursor among data fields in the dialogue. Once the
  785.   cursor is in the editing window, use ESC to move it out of the
  786.   window into another field of the dialogue.
  787.  
  788.   IMPORTANT: NEVER place control or "highbit" characters into file
  789.              titles, keywords, or descriptions.
  790.  
  791.  
  792. When you're done entering file-upload information, press F10 to
  793. confirm it and close the dialogue. Or press ESC to close the dialogue
  794. without saving the information. OzCIS will not allow you to close the
  795. dialogue and save the information until you've filled in all of the
  796. data fields.
  797.  
  798. CAUTION:  Pressing ESC will close the dialogue immediately - without any
  799.           query from OzCIS. Keep a light touch on the ESC key when you
  800.           use it to move the cursor out of the DESCRIPTION window!
  801.  
  802. Closing the dialogue and confirming the information creates a file (in
  803. the forum's subdirectory) whose base name is the first 8 characters of
  804. the forum's "GO" name and whose extension is .UL (like: DTPFORUM.UL).
  805. If there is now an .UL file, OzCIS appends the new information to it.
  806.  
  807. OzCIS reads the contents of the .UL file and makes the uploads to the
  808. forum at the end of a 1st or 2nd pass, then deletes the .UL file from
  809. the forum's subdirectory.
  810.  
  811.  
  812.         REVIEWING OR ALTERING UPLOAD INFORMATION
  813.  
  814. This release of OzCIS does not have a VIEW UPLOADS menu similar
  815. to the VIEW DOWNLOADS menu selection in a short- or long-format
  816. catalogue window. But there is a way to review pending uploads and
  817. change information within the .UL file.
  818.  
  819. Select FORUMS > CUSTOM SERVICES > EDIT ONLINE PROCESS FILE. An ONLINE
  820. FILES window opens at the right of the screen. Select "Pending Uploads
  821. (.UL)".
  822.  
  823. The General Editor immediately finds and opens the .UL file for the
  824. selected forum. If there isn't any such file, OzCIS displays an error
  825. message saying there are no pending uploads. Here is how the
  826. information for a file upload appears in the .UL file:
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.   ------------------------------------------------------------------
  838.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 122
  839.  
  840.  
  841.  
  842.  
  843.   ;6;ASCII;DTPREV.TXT;D:\TEXT\DTPREVUE.TXT
  844.   This text file contains a summary of various trade magazines' reviews
  845.   of a number of DTP programs for use under Windows and on the Mac.
  846.   Subjects covered include user interface features, typographic
  847.   features, graphics handling capabilities, trapping functions, system
  848.   requirements, and list prices.
  849.  
  850.   *EOM*
  851.   DTP PROGRAMS DESCRIPTION REVIEW DOS MAC WINDOWS COMPARISON
  852.   Overview of current PC/Windows/Mac DTP programs
  853.  
  854. (The first-line indents, above, are used to make the information stand
  855. out from other text here but are not present in the .UL file itself.)
  856.  
  857. If you edit this file, make very sure not to alter its overall format.
  858. In particular, do not change the positions of semicolons in the first
  859. line, nor delete or add any semicolons. The first line contains:
  860.  
  861. Library number (in this case, "6"); the file type ("ASCII"); the name
  862. to be used on CIS ("DTPREV.TXT"); the file's name and path on your
  863. system ("D;\TEXT\DTPREVUE.TXT"); and the extended description
  864. (abstract) follows. If you must edit the abstract, be careful not to
  865. increase its length past the maximum of 549 chraracters. An end-of-
  866. message flag ("EOM") follows. Make sure to LEAVE IT ON A LINE BY
  867. ITSELF.
  868.  
  869. There are two asterisks in the line containing "EOM," above. In
  870. the .UL itself file there will not be asterisks, but rather two
  871. "highbit" (box-drawing) characters required by OzCIS. (We have removed
  872. the highbit characters from the documentation, figuring that some
  873. people's dot-matrix or letter-quality printers cannot reproduce them.)
  874. DO NOT ALTER OR REMOVE THE HIGHBIT CHARACTERS.
  875.  
  876. If you accidentally delete one of them: The character to the immediate
  877. left of "EOM" has the decimal value of 204; the character to the
  878. immediate right of "EOM" has the decimal value of 185. Most text
  879. editors - and OzCIS' General Editor as well - support the entry of
  880. highbit characters via the ALT-plus-numeric-keypad method. I.e., ALT-
  881. 204 would print the highbit character placed to the left of "EOM".
  882.  
  883. The next line (text in all caps) contains the keywords. The final
  884. line is the short description.
  885.  
  886. The next block of file information, if any, in an .UL file should be
  887. separated from the previous block by a single blank line.
  888.  
  889. There is no quick "delete .UL file" option in this release of OzCIS.
  890. If you want to delete an .UL file entirely, you must do so at the DOS
  891. prompt.
  892.  
  893.  
  894.  
  895.  
  896.  
  897.   ------------------------------------------------------------------
  898.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 123
  899.  
  900.  
  901.  
  902.  
  903. On the other hand, if you would rather not exit from OzCIS to kill all
  904. pending uploads, use the General Editor to remove all of the lines in
  905. the .UL file, leaving an empty .UL file on disk. OzCIS, finding
  906. nothing in the file, will ignore it.
  907.  
  908.                             # # #
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.   ------------------------------------------------------------------
  958.   OzCIS 1.0  Copyright 1992 Steve Sneed                     Page 124
  959.  
  960.  
  961.